home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD2.iso / Programming / C / hf^k-1.dms / in.adf / Readme < prev    next >
Encoding:
Text File  |  1996-01-19  |  6.7 KB  |  225 lines
  1. © HAAGE & PARTNER Computer GmbH 
  2.  
  3.   Mainzer Straße 10A
  4.   D-61191 Rosbach.
  5.   Germany
  6.  
  7.   Tel: ++49  60 07 / 93 00 50
  8.   Fax: ++49  60 07 / 75 43
  9.  
  10.   Compuserve: 100654,3133
  11.   Internet: 100654.3133@compuserve.com
  12.   Homepage: http://ourworld.compuserve.com/homepages/haage_partner
  13.  
  14. First of all we want to thank you for purchasing StormC. So you told
  15. us that we did the right thing by developing StormC.
  16.  
  17. These are the changes in comparison to Version 1.1:
  18. ======================================================================
  19.  
  20. StormShell
  22. - Expandet optiondialog
  23. - GoldED 4.0 is includet in the package
  24.  
  25. Project Manager
  27. - Make of hierarchical projects
  28. - Own ARexx-Makescripts
  29. - New project section for StormLibrarian
  30.  
  31. StormEd
  33. - bracket-check
  34. - block indent
  35. - new colour controls
  36. - new project template
  37.  
  38. StormRun
  40. - Stack and CPU register window
  41. - Disassembler
  42. - Profiler
  43.  
  44. StormC
  46. - new optimisation levels
  47. - new keyword "__interrupt"
  48.  
  49. StormLibrarian
  51. - simple creation of linker libraries
  52. - Sort function
  53.  
  54. Tools
  56. - FD2Pragma
  57.  
  58.  
  59. Editor Key Map:
  60. ************************
  61.  
  62. Shift-Cursor Up/Down
  63.         Moves the cursor to the first/last line displayed in the window.
  64.  
  65. Shift-Cursor Left/Right
  66.         Moves the cursor to the first/last column of the current line.
  67.  
  68. Alt-Cursor Up/Down
  69.         Jumps to the start/end of the text.
  70.  
  71. Alt-Cursor Left/Right
  72.         Moves the cursor to the next word in front of or behind the cursor.
  73.  
  74. Shift-Delete oder Shift-Backspace
  75.         Deletes the line the cursor stands. It is stored in the clipboard.
  76.  
  77. Alt-Delete
  78.         Deletes the line starting form the position of the cursor to the end.
  79.  
  80. Alt-Backspace
  81.         Deletes the text from the start to the cursor position.
  82.  
  83. Help
  84.   Opens the Online Help and displays an explanation to the word under the cursor.
  85.   The word must be an ANSI-C or C++ standard function.
  86.  
  87.  
  88. Advices to PhxAssembler
  89. ************************
  90.  
  91. As a bonus the freeware assembler FreePhxAss is delivered with
  92. StormC. It is mainly for useful for developers of PD compilers which
  93. use it for translation of their compiler output. The function size
  94. is *very* limited: There are no macros, no includes, no conditioned
  95. assembling. Many directives are also not available. 
  96.  
  97. FreePhxAss can be used freely, but the name of the Author should
  98. be mentioned in the project.
  99.  
  100. If you are interested in PhxAss, there is a registered version that
  101. is available at a low price.
  102.  
  103. Please contact
  104.  
  105. SMail:                  Frank Wille
  106.                         Auf dem Dreische 45
  107.                         32049 Herford
  108.                         Germany
  109.  
  110. EMail:                  frank@phoenix.owl.de
  111.  
  112.  
  113. Some Frequently asked Questions and Answers !
  114. *****************************************
  115. Q 1:
  116. ********
  117.  
  118. Why has StormC no Global Optimiser" ?
  119.  
  120. Answer:
  121. The compiler of StormC offers already a good optimisations. Some of
  122. the used techniques are also part of a global optimiser. Especially
  123. the optimised organisation of the global CPU and FPU registers is such
  124. a one.
  125.  
  126. StormC is already prepared to do more of the global optimisations in
  127. further versions. They can be implemented step by step. But as said
  128. before the optimisation of StormC and StormLINK. 
  129.  
  130. Q 2:
  131. ********
  132.  
  133. Why does a small "Hello World" gets so long (some Kbytes) ?
  134.  
  135. Answer:
  136. "Storm.lib" is a highly compatible ANSI C library that offers buffered I/O.
  137.  
  138. The program "Hello World" uses "printf" of the "Storm.lib", but it
  139. does not differ between the output of integer or floating point, so
  140. there are unused parts of the library in your code that makes small
  141. programs relatively large.
  142.  
  143. If only ANSI C is used the library "StormAmiga.lib" can be used. This
  144. is a highly optimised assembler library that generates very small and
  145. fast programs. It only supports "far code" and "far data" model.
  146.  
  147. Q 3:
  148. ********
  149.  
  150. How can I get a short "Hello World" using Storm.Lib ?
  151.  
  152. Answer:
  153. If floating point is needed and buffered I/O of AmigaDOS is enough
  154. AmigaDOS functions can be used for this. "Vprintf" and "VFPrintf"
  155. will directly output to AmigaDOS files, just like "printf". But these
  156. functions are not 100% ANSI compatible.
  157.  
  158. Another possibility is to resign on automatically open and close of
  159. libraries and its comfortable error handling which differs between
  160. Workbench and CLI start while paying attention to OS 1.3 and older.
  161. This comfort is not necessary for all programs.
  162.  
  163. So a minimal startup code, written in assembler can be used, that only
  164. does the essential jobs, e.g. only supporting the small data model,
  165. not supporting resident programs ...
  166.  
  167. Q 4:
  168. ********
  169.  
  170. Why is the library "storm.lib" such a big one and why is there
  171. only a single one (in contrast to SAS/C) ?
  172.  
  173. Answer:
  174. StormC support a further developed object format that is used for
  175. linker libraries as well. It is 100% compatible to the old one. Its
  176. advantage is that the Linker and the Compiler of StormC can accommodate
  177. more data models in one object file. So the programmer must not decide
  178. which is the right library that fits the used data model (far data,
  179. near data(a4), near data(a6)). This caused many errors. Now the linker
  180. takes the needed parts out of "Storm.lib". For these reasons "Storm.lib"
  181. is nearly as big as these three libraries of SAS/C.
  182.  
  183. In the future StormC will support even more code modells and CPU and
  184. FPU models, so "Storm.lib" will allow the optimised program generation
  185. automatically.
  186.  
  187. Q 5:
  188. ********
  189.  
  190. Why does the linker displays the error message "Symbol _exit
  191. not defined", when linking as Shared Library ?
  192.  
  193. Answer:
  194. The Shared Library calls the ANSI function exit(). This can be done
  195. directly by the programmer or indirectly by the linker library which
  196. uses this function. "Storm.lib" uses this function to automatically
  197. open the used Shared Library, e.g. the "utility.library".
  198.  
  199. Basically a Shared Library is not allowed to use exit(), cause it
  200. can not be finished simply.
  201.  
  202. How to avoid this call ?
  203.  
  204. You should not use the automatic opening of used Shared Libraries.
  205. Instead you must open and close the library as it is described in
  206. the manual.
  207.  
  208. To get a list of all used libraries you should include
  209.  
  210. void exit() {}
  211.  
  212. into the Shared Library. Now you can link it.
  213.  
  214. You should use the linker option "Write Map File". The linker will
  215. generate a file with the extension ".map". Now watch all INIT
  216. functions which contain the basis name of the Shared Library, e.g.
  217. INIT_1_UtilityBase.
  218.  
  219. Now open all these libraries with your own routines. Pay attention
  220. to declare the corresponding basis variable (e.g. UtilityBase). Do not
  221. forget to remove your own exit() function from the source. 
  222.  
  223. (c) HAAGE & PARTNER Computer GmbH - We develop to PowerUp the AMIGA
  224.  
  225.